home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 033a / appmap11.zip / APPMAP.DOC < prev    next >
Text File  |  1993-02-18  |  11KB  |  275 lines
  1.   AppMap Version 1.10 Instructions
  2.  
  3.   Getting Started
  4.  
  5.   The first thing you need to do is run APPMAP.COM by placing it
  6.   in your AUTOEXEC.BAT file or by typing APPMAP. This is the
  7.   driver which will remap your keypresses when running your
  8.   different applications. APPMAP only needs to be run once when
  9.   your computer is started. Running APPMAP.COM a second time will
  10.   remove it from memory.
  11.   Now you need to create your remap files for each application you
  12.   wish some or all of the key combinations changed. These files
  13.   have the extension KMP. To do this type MAKEMAP, a space, and
  14.   then the eight character filename you wish to call this map
  15.   file.
  16.  
  17.   For example:  You wish to change some key combinations in your
  18.                 TurboWrite editor. Type  MAKEMAP TURBOWRI at the
  19.                 DOS prompt. (as shown below)
  20.                 C>MAKEMAP TURBOWRI
  21.  
  22.   Using MAKEMAP.EXE
  23.  
  24.   After running MAKEMAP the following screen will be displayed:
  25.   -------------------------------------------------------------
  26.  
  27.   C>MAKEMAP TURBOWRI
  28.  
  29.   Make Application Keyboard Map Utility Version 1.10
  30.   (C)Copyright. 1993, By Mark Vitt, All Rights Reserved
  31.  
  32.   USAGE: MAKEMAP filename.KMP </P>
  33.  
  34.   /P  =  Print KMP file map information
  35.  
  36.   Remap another key for TURBOWRI.KMP (Y/N) ?
  37.   -------------------------------------------------------------
  38.  
  39.   Press the Y key to remap/change another key combination
  40.  
  41.   Now you are asked:
  42.   -------------------------------------------------------------
  43.   Press the keys that will REPLACE old key combination...
  44.   -------------------------------------------------------------
  45.  
  46.   Press the keys that you wish to use. Since I wish to use
  47.   Alt-F instead of F6 key that TurboWrite requires, I'll
  48.   press Alt-F at this prompt.
  49.  
  50.   You are now asked for the key combination that will be replaced
  51.   by the keys you just selected (ie. Alt-F):
  52.  
  53.   -------------------------------------------------------------
  54.   Press keys that Alt-F will replace...
  55.   -------------------------------------------------------------
  56.  
  57.   Since I want Alt-F to replace F6, I'll press F6 here.
  58.  
  59.   Remap another key for TURBOWRI.KMP (Y/N) ? is displayed again,
  60.   press Y to remap another key combination or N when you have
  61.   finished changing all the key combinations you wish to change.
  62.  
  63.   When you press N at Remap another key for ????????.KMP (Y/N) ?
  64.   the following will be displayed:
  65.   -------------------------------------------------------------
  66.   Send AppMap Information for TURBOWRI.KMP to:
  67.   1) LPT1
  68.   2) LPT2
  69.   3) LPT3
  70.   4) Screen
  71.   5) TURBOWRI.TXT file
  72.   X) Exit
  73.  
  74.   Press the number choice ?
  75.   -------------------------------------------------------------
  76.   If you want to see how the keys will be remapped when using
  77.   the TURBOWRI.KMP file, select the option of where to send the
  78.   information by pressing the number for that option. (ie. 1 for
  79.   printer connected to LPT1, 4 for screen, etc)
  80.  
  81.   Now that you've created your KMP file you need to let APPMAP
  82.   know you wish to use it. This is done by running SETMAP either
  83.   in a batch file before your program is loaded or at the DOS
  84.   prompt. For the TurboWrite remap file we just created you would
  85.   type: SETMAP TURBOWRI
  86.   A message will be displayed telling you the Key map for TURBOWRI
  87.   is loaded. You now can use the keys you selected in MAKEMAP in
  88.   TurboWrite.
  89.  
  90.   NOTE: When MAKEMAP is run any current mapping set by SETMAP is
  91.         disabled.
  92.  
  93.  
  94.   Using SETMAP.EXE
  95.  
  96.   USAGE: SETMAP filename.KMP  </N>
  97.  
  98.   This loads the specified KMP file into APPMAP. The last KMP or
  99.   keyboard map file remains active until SETMAP /N is used or
  100.   another KMP file is loaded by SETMAP.
  101.  
  102.   Messages displayed by SETMAP are:
  103.  
  104.   MESSAGE:  ????????.KMP file was not found
  105.   MEANING:  Means SETMAP could not find the file specified in
  106.             the current directory
  107.  
  108.   MESSAGE:  Keyboard Driver not found in memory check
  109.             APPMAP.COM must be loaded before you can use SETMAP
  110.   MEANING:  APPMAP.COM must be run before using SETMAP
  111.  
  112.  
  113.   MESSAGE:  Keyboard remapped using ????????.KMP
  114.   MEANING:  The KMP file was loaded successfully and the keyboard
  115.             has been remapped.
  116.  
  117.   MESSAGE:  All mapping disabled
  118.   MEANING:  All remapping of keyboard has been disabled. The
  119.             default keys for application programs and DOS will be
  120.             used.
  121.  
  122.  
  123.   Using APPMAP.COM
  124.  
  125.   APPMAP.COM must be loaded to perform keyboard remapping. To do
  126.   this type APPMAP. The message Installed. Run SETMAP to load
  127.   keyboard mappings. will be displayed when it has been successfully
  128.   loaded.
  129.  
  130.   If you wish to use remapping for only one or two applications,
  131.   you can create a batch to use mapping only for these
  132.   applications and save alittle memory for other programs.
  133.  
  134.   Example: You wish to only remap the keys used for MyWrite word
  135.   processor. First create the KMP file using MAKEMAP. Then create
  136.   this batch file using DOS's Edit:
  137.  
  138.   Batch File Contents      Description of Batch File Line
  139.   -------------------      ------------------------------
  140.   APPMAP                   Load AppMap Keyboard Driver
  141.   SETMAP MYWRITE           Load your KMP map file
  142.   MYWRITE                  Run Word Processor
  143.   APPMAP                   Remove AppMap from Memory
  144.  
  145.   For more information on batch files, see your DOS users manual.
  146.  
  147.   If you wish to remap the keys for several applications, load
  148.   APPMAP.COM from your AUTOEXEC.BAT file, then create a batch
  149.   file to run each application that will load your KMP map file
  150.   before that application is run.
  151.  
  152.   Example: For running MyWrite word processor:
  153.  
  154.   Batch File Contents      Description of Batch File Line
  155.   -------------------      ------------------------------
  156.   SETMAP MYWRITE           Load your KMP map file
  157.   MYWRITE                  Run Word Processor
  158.   SETMAP /N                Disable keyboard mapping
  159.  
  160.   For more information on batch files, see your DOS users manual.
  161.   The last line in the batch file (SETMAP /N) is used here
  162.   incase some of the keys remapped are DOS keys such as the
  163.   F3 key. If this line is omitted from your batch file, then
  164.   the key used to replace F3 will still be remapped in DOS.
  165.   Example: Alt-F replaces F3 in your MYWRITE.KMP file, then
  166.   pressing Alt-F will have the same affect in DOS (or any other
  167.   application) as F3 does.
  168.  
  169.   NOTE: SETMAP and APPMAP output maybe redirected to the NUL
  170.   device. (ie. SETMAP MYWRITE > NUL:) If an error is encountered,
  171.   SETMAP will display it to your screen whether or not output was
  172.   redirected.
  173.  
  174.  
  175.   APPMAP.COM Messages
  176.  
  177.   MESSAGE: Installed. Run SETMAP to load keyboard mappings.
  178.   MEANING: Keyboard Driver loaded successfully.
  179.  
  180.   MESSAGE: AppMap Keyboard Driver is now uninstalled
  181.   MEANING: Keyboard Driver has been removed from memory.
  182.            APPMAP.COM must be rerun to use keyboard mapping.
  183.  
  184.   MESSAGE: AppMap requires DOS Version 3.0 or higher to uninstall
  185.   MEANING: Keyboard Driver has loaded successfully but cannot be
  186.            unloaded from memory.
  187.  
  188.   MESSAGE: Unable to uninstall, Interrupt chain would be broken
  189.   MEANING: Another TSR or program is chaining its interrupts to
  190.            the AppMap routines. If AppMap removes itself from memory
  191.            your system would lockup. To remove AppMap from memory
  192.            first remove the programs run after AppMap from memory and
  193.            try again.
  194.  
  195.  
  196.   When AppMap will not work
  197.  
  198.   AppMap will not work if an application intercepts the keyboard
  199.   hardware and saves the keyboard buffer before passing this
  200.   information on. Very few software programs do this, but, of
  201.   course, Windows does. So AppMap will not work in Windows. On
  202.   the plus side, if AppMap for DOS is successful, and demand
  203.   requires, a Windows version will be developed.
  204.  
  205.   Also, AppMap will replace one and two key combinations only.
  206.  
  207.   Files Required for AppMap
  208.  
  209.   Name              Description
  210.   ---------------   -------------------------------------------
  211.   APPMAP.COM        Memory resident Keyboard Driver
  212.   MAKEMAP.EXE       Create KMP file for changing keypress
  213.                     combinations SETMAP.EXE Loads KMP file and
  214.                     remaps keys as specified when the KMP file
  215.                     was created by MAKEMAP
  216.   README.EXE        Displays README.TXT file on the screen
  217.   README.TXT        Installation and other information (ASCII)
  218.   APPMAP.DOC        Instructions for using AppMap (ASCII)
  219.   SHOWDOC.BAT       Display APPMAP.DOC using DOS's MORE
  220.  
  221.   Customer Support
  222.   You can ask questions by leaving messages on CompuServe
  223.   addressed to user ID 70053,2236. Ideas for upgrades and
  224.   enhancements are welcome. You may also call 813-267-5370 and
  225.   leave a message with the best time to return your call. Please
  226.   do not contact distributors for technical assistance, since
  227.   they generally will not be able to give you the same personal
  228.   attention and expertise the author can provide.
  229.  
  230.  
  231.          ----------------end-of-author's-documentation---------------
  232.  
  233.                          Software Library Information:
  234.  
  235.                     This disk copy provided as a service of
  236.  
  237.                            Public (software) Library
  238.  
  239.          We are not the authors of this program, nor are we associated
  240.          with the author in any way other than as a distributor of the
  241.          program in accordance with the author's terms of distribution.
  242.  
  243.          Please direct shareware payments and specific questions about
  244.          this program to the author of the program, whose name appears
  245.          elsewhere in  this documentation. If you have trouble getting
  246.          in touch with the author,  we will do whatever we can to help
  247.          you with your questions. All programs have been tested and do
  248.          run.  To report problems,  please use the form that is in the
  249.          file PROBLEM.DOC on many of our disks or in other written for-
  250.          mat with screen printouts, if possible.  PsL cannot debug pro-
  251.          programs over the telephone, though we can answer questions.
  252.  
  253.          Disks in the PsL are updated  monthly,  so if you did not get
  254.          this disk directly from the PsL, you should be aware that the
  255.          files in this set may no longer be the current versions. Also,
  256.          if you got this disk from another vendor and are having prob-
  257.          lems,  be aware that  some files may have become corrupted or
  258.          lost by that vendor. Get a current, working disk from PsL.
  259.  
  260.          For a copy of the latest monthly software library newsletter
  261.          and a list of the 4,000+ disks in the library, call or write
  262.  
  263.                            Public (software) Library
  264.                                P.O.Box 35705 - F
  265.                             Houston, TX 77235-5705
  266.  
  267.                                 1-800-2424-PSL
  268.                              MC/Visa/AmEx/Discover
  269.  
  270.                           Outside of U.S. or in Texas
  271.                           or for general information,
  272.                               Call 1-713-524-6394
  273.  
  274.  
  275.